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1 

2 TRANSLATOR-COMPILER FOR CONVERTING LEGACY MANAGEMENT 

3 SOFTWARE 

4 
5 

6 BACKGROUND OF THE INVENTION 

7 

8 1. Field of the Invention: 

9 The present invention relates generally to management software, and, more 

10 particularly, relates to converting legacy or proprietary management software into 

11 software compatible with new industry-standard architecture. 
12 

13 2. Description of Prior Art 

14 To say that growth of the computer industry has been rapid is something of an 

15 understatement. Computer companies develop and market (1) hardware such as 

16 mainframes, personal computers, peripherals including storage systems, printers, 

17 terminals and modems; (2) software which runs on and controls that hardware such as 

18 operating systems software and applications software such as peripheral-device 

19 management software; and, (3) networking infrastructure, such as the Internet, 

20 employing this hardware and software. As noticed by many, this industry is a powerful 

21 engine pulling civilization forward in an almost uncomfortably rapid manner. 
22 

23 Because of constant, intense and competitive technological design enhancement 

24 activity inherent in this industry, different, and frequently incompatible, technical designs 

25 are created. Such incompatibility can result in difficult situations, as, for example, where 
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1 a corporate user of this technology utilizes, for example, different storage systems each 

2 having architecture incompatible with the others, internal to its own organization. In this 

3 circumstance, each storage system vendor has produced its own proprietary or "legacy" 

4 architecture and supplied same to this corporate-customer user who now has the 

5 challenge of managing or handling such incompatibility in as efficient and graceful a 

6 manner as possible. Regrettably, one storage system management software package 

7 cannot readily communicate with a different vendor's storage system management 

8 software package within the same corporate environment, without arduous code 

9 generation to close the communication gap! Thus, this corporate user, unfortunately, is 
? 3 10 now burdened with meeting this challenge including the taking of redundant actions. 

11 Such actions are, for example, providing multiple training sessions to its employees, so 

£ 12 they can describe and handle failures, degradations and other complications which may 

"4 13 arise in these incompatible storage systems, in as many different languages as are dictated 

Q 14 by such different legacy or proprietary architectures defining such systems. This 

5 15 confusing and inefficient scenario results from an availability of too many different kinds 

H 16 of management tools and places an unwanted drain on this corporate user's resources. 

17 Accordingly, computer industry vendors have created standards committees and 

18 organizations in which their companies can be represented, for purposes of interacting 

19 and generating standards of design for the good of all concerned, including corporate- 

20 customer users as exemplified above. 
21 

22 Thus, one technical area where need for standardization is apparent is in the 

23 computer storage-system management arena where certain storage-management software 

3 
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1 products are based on older, less-desirable, or increasingly-incompatible legacy or 

2 proprietary architectures. These architectures are combinations of software such as 

3 schemas, languages and protocols, etc. For example, referring to Fig. 2A, one such 

4 legacy architecture hierarchy is depicted: at the bottom of the architecture stack are 

5 protocols: TCP/TP (Transmission Control Protocol / Internet Protocol), Sockets, and 

6 Rogue Wave (Net.H++). On top of those protocols, in this example, is object-oriented 

7 computer language C++. And on top of that computer language is a schema (header- 

8 related software and further defined hereinbelow) such as that derived from or 

9 implemented in RAID++. RAID ++ is an object-oriented representation of a 

10 CLARiiON® storage system (registered trademark of assignee) in C++ language, and 

11 objects are defined below. 

12 

13 Legacy architecture such as that comprising TCP/IP, Sockets, Rogue Wave and 

14 schemas is fundamental to the design of networks such as, for example, a client-server 

15 network. In a client -server network, several communication aspects need to be 

16 specified: (1) How does the client communicate with the server? TCP/IP over an 

17 ethernet cable would be responsive to this question. (2) What language will be used by 

18 the client and server? Rogue Wave and Sockets are among the answers responsive to this 

19 question. (3) What language is the code written in? C++ or JAVA would be examples of 

20 languages responsive to this question. (4) What subject will be talked about? Schema 

21 would focus the subject to particular subject matter such as, for example, "storage 

22 management" as opposed to, for example, "extracting banking information. Thus, legacy 

23 architecture defines the client-server network. 

4 



' WIIIMIIf'MIll 



Assignee docket No: EMC-00-135; Attorney docket No. JW-EMC-007 PATENT 

1 

2 Although legacy or proprietary architectures can still be useful under certain 

3 circumstances, they are generally no longer the architecture of choice for reasons of 

4 incompatibility noted above and for other reasons. For example, it is not unusual for 

5 legacy or proprietary architecture to employ C++ language. Such language is typically 

6 represented in object "trees" because C++ fits naturally with tree representation, 

7 (although C++ can also be represented otherwise). Tree representations have certain 

8 analytical-design disadvantages as compared with a flat object representation. Objects, 

9 object trees, and an improved "flat" object database representation, all in connection with 

10 industry standardization, are described as follows. One industry standardization effort is 

11 being conducted by the Distributed Management Task Force, Inc. (DMTF) and is moving 

12 in a direction entitled: "Web-Based Enterprise Management" (WBEM). One area being 

13 addressed by this effort is within the aforementioned software category known as "object- 

14 oriented" software. An object, in computer software terms, is a dedicated area of 

15 memory which can be thought of as an impervious container holding both data and 

16 instructions within itself, both defining itself and its relationships to other objects in the 

17 computer system or network. An object can send and receive messages to and from other 

18 objects, respond and react to such messages (e.g. commands) but shall normally be 

19 impervious to internal scrutiny. For example, in a storage processor (a kind of computer) 

20 each object may describe or relate to a specific detail in the processor (e.g. a fan, power 

21 switch, cache memory, power supply, disk drive interface, etc.), where these tangible 

22 objects in the storage processor can send messages to each other and to other objects 

23 outside the processor. 
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1 

2 If operating with C++ computer language, as noted above, the relationship 

3 between these specific objects in the storage processor is usually visualized or 

4 characterized as a "tree" of objects. In a tree, each such object hangs off a preceding 

5 object as if in a parent-child or inheritance relationship, with many children hanging from 

6 a parent not being an atypical configuration. In addition to these tangible kinds of 

7 objects, logical units (LUNs) are other nodes or objects that can be contained within the 

8 tree. If a user wants to know, for example, about all existing LUNs (and there can be a 

9 vast number) in a particular tree configuration, any hardware/software search solution for 

10 them is necessarily based on a design which must, in turn, be based on such tree 

1 1 representation. Thus, a search through the entire tree must be conducted to find all 

12 LUNs, which can be a cumbersome and time consuming task under certain conditions. 

13 Furthermore, even if not searching for LUNs, in order for a search or message transfer to 

14 proceed in the tree from one node or object to another, again the entire tree may have to 

15 be navigated. When there are thousands or more of these objects in the tree, this could 

16 take too much time as a message passes from object to object within the tree. 

17 Accordingly, for these and other reasons not relating to performance WBEM is 

18 establishing a standard that avoids object trees and arranges all objects in a database 

19 where a "flat" relationship is obtained, i.e., objects can communicate from one to the 

20 other directly and need not proceed through intermediary objects as required in the tree 

21 configuration. Flat-database-represented extensive Markup Language (XML) has been 

22 selected by WBEM. 
23 
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1 XML, in addition to allowing a flat object database where one object can 

2 communicate directly with any other object in the database, is a language that offers other 

3 advantages with respect to Internet usage. XML is related to or is a superset of Hypertext 

4 Markup Language (HTML), and Internet browsers display information in HTML. XML 

5 thus enables companies to leverage Web technologies to manage enterprise systems such 

6 as storage systems. Therefore, XML is a language of choice in view of its Internet 

7 compatibility. 
8 

9 Referring to Fig. 2B, a new architecture stack is shown and is to be compared 

10 with the legacy architecture stack of Fig. 2A. In Fig. 2B, the earlier-noted TCP/IP 

1 1 protocol is still at the bottom followed by the aforementioned HTTP protocol, on top of 

12 which is the aforementioned XML computer language; and, on top of XML is a new and 

13 advantageous schema called Common Information Model (CIM). (A schema can be 

14 viewed as a description of a class structure, i.e., the schema enumerates all the classes, 

15 how they are related to each other in terms of reference to each other and in terms of 

16 parent-child inheritance relationships, maybe including a description of all properties that 

17 these classes may have, and maybe further including all methods that can be executed in 

18 those classes.) A ninety-seven (97) page specification entitled "Common Information 

19 Model (CIM) Specification" Version 2.2, dated June 14, 1 999 prepared by the 

20 Distributed Management Task Force, Inc. (DMTF) offers more information about this 

21 subject and is incorporated by reference herein in its entirety; electronic copies of this 

22 specification can be obtained free of charge from the Internet at ftp://ftp.dmtf.org or 

23 http://www.dmtf.org . Another specification of eighty-seven (87) pages entitled 

7 
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7 



1 "Specification for CIM Operations of HTTP" Version 1 . 0, dated August 1 1 th , 1 999, 

2 prepared by DMTF likewise provides valuable background information and is also 

3 incorporated by reference herein in its entirety. CIM is superior to older, legacy-based 

4 schemas in the one respect that it creates interoperability and allows management of 

5 different storage systems supplied by different vendors. CIM also has capability of 

6 modeling servers, software on servers, power supplies on servers, network switches, tape 
backup, and virtually all other manageable components in a computer system. 



9 Serious potential effort and expense issues enter into this scenario when 

10 considering the huge legacy architecture which has been developed in this industry thus 

1 1 far. There has been major investment on the part of many industry participants (multiple- 

12 hundreds of industry vendors) in each of their own respective brands of proprietary or 

13 legacy architecture. Such architecture is not only the specific layered architecture shown 

14 in Fig. 2A useful with at least CLARiiON® storage systems (registered trademark of 

15 assignee), but any legacy architecture including that which is not in conformance with 

16 Fig. 2A and different from the proposed standard of Fig. 2B. As industry vendors know, 

17 to change one' s investment from any legacy architecture, e.g. that represented by Fig. 2 A 

18 to that of Fig. 2B, is a major undertaking typically requiring the writing of a huge number 

19 of lines of code. What is needed for the industry, therefore, for both industry vendors and 

20 users alike, is an automatic conversion technique to permit the large investment made by 

21 multiple industry participants, regardless of their specific legacy architecture, to be 

22 preserved and upgraded to the new standard stack of Fig. 2B, or to any other new 

23 standard, automatically and with minor impact on their respective businesses. 
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1 

2 Embodiments of the present invention provide a welcome solution to the 

aforementioned prior art problems. Such embodiments are far easier to implement than 

4 the aforementioned line-by-line code upgrade conversion. Moreover, not only do such 

5 embodiments relate to and solve specific problems associated with the particular legacy 

6 architecture shown in Fig. 2A, but their underlying algorithms can also provide a solution 

7 to almost any legacy architecture upgrade challenge. 



9 

10 SUMMARY OF THE INVENTION 

1 1 Embodiments of the present invention relate to a translator-compiler for 

12 converting legacy management software and further relate to permitting communication 

13 between a first computer's management software operating in accordance with first or 

14 legacy architecture and a second computer's management software operating under 

15 second or new-standard, non-legacy architecture. 
16 

17 More specifically, embodiments of the present invention relate to an interface 

18 between a first computer network operating in accordance with first architecture and a 

19 second computer network operating in accordance with second architecture incompatible 

20 with the first architecture, to automatically convert management software communication 

21 from the second computer network into a form compatible with the first computer 

22 network, and to automatically convert response to the management software 
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1 communication generated by the first computer network into a form compatible with the 

2 second computer network. 

4 Even more specifically, embodiments of the present invention relate to computer 

5 systems, computer networks, methods, and computer program products employing 

6 management software written in a first computer language compatible with a first 

7 architecture such as legacy architecture and not compatible with a second architecture 

8 such as preferred, non-legacy architecture. Such legacy architecture contains a schema 

9 which, in turn, contain header files represented in the first computer language. Header 
O 10 files are capable of being utilized by the management software. The header files are 

F? 11 manipulated to locate certain or all public functions and/or data attributes. Responsive to 

J 12 such manipulation, code is emitted that calls all such public functions and/or data 

SJ 13 attributes which are converted to representations formed in a different computer language 

□ 14 compatible with the preferred non-legacy architecture. Such management software can 

"r 15 be storage management software, printer management software, server management 

F? 16 software, etc., and embodiments of the present invention are not intended to be limited to 

17 any particular management software functionality. 

18 

19 In a further feature of the present invention, the first computer language is an 

20 object-oriented language defining computer data and commands as objects. In such an 

21 environment, at least one of the header files containing a declaration of at least one of the 

22 objects is opened and parsed to obtain the name of the class and of the parent class to 

23 which it belongs. A subroutine is created to accept such object(s) in the first computer 

10 
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1 language and to generate the equivalent of such object(s) in a different computer 

2 language compatible with the preferred, non-legacy architecture. 
3 

4 In yet another feature of the present invention the first computer language is an 

5 object-oriented language capable of pictorial representation typically in a parent-child 

6 tree configuration, such as, for example, C++, or RAID++, and the different computer 

7 language is a second object-oriented language capable of pictorial representation 

8 typically in a flat database configuration, such as, for example, XML/CEVI. 
9 

Cl 10 i n another aspect, embodiments of the present invention relate to a computer 

[5 1 1 network operating in accordance with legacy architecture, including a client and a storage 

J 12 system (including but not limited to a storage area network - SAN), having management 

Q 13 software operating thereon in accordance with such legacy architecture. A translator- 

O 14 compiler creates code that permits communication between the computer network and 

S 15 other devices outside of the network operating under preferred, non-legacy architecture. 

H 16 Program code accesses and parses such management software's header files located 

17 within a schema, opens an output file to store related information and results, locates 

18 certain or all public data attributes and/or public functions within the header file, and 

19 emits special code to the output file that calls such public data attributes and/or public 

20 functions and converts them to language compatible with said preferred, non-legacy 

21 architecture. Thereby, communication about managing the storage system, generated 

22 between the computer network including the storage system on the one hand, and devices 

23 operating under non-legacy architecture outside the computer network on the other hand, 

11 
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1 is achieved. Further, this communication is achieved without having to completely 

2 abandon any investment made in the proprietary implementation. 

3 

4 In yet another aspect, embodiments of the present invention relate to computer 

5 program product such as distributed management software to be operated on a computer 

6 compatible with certain architecture. First requests in first language(s) incompatible with 

7 the certain architecture are received. Responses to the first requests are obtained in 

8 second language compatible with the certain architecture. And, the responses are 

9 converted to equivalent responses compatible with the first language and are 

10 communicated to the destination from which, or to another destination related to that 

1 1 destination from which, the first requests originated. A related destination can be either 

12 the destination from which the requests originated or can be that specified or determined 

13 by information in such requests. Distributed management software can be, e.g. , storage 

14 management software. And, the first language(s) can be a plurality of languages each 

15 being incompatible with the second language, in which case the responses are converted 

16 to a like plurality of equivalent responses each being constructed in one of the plurality of 

17 languages and destined for its like -language source. In this case, the second language is 

18 compatible with legacy or proprietary architecture, and the first languages are compatible 

19 with a plurality of preferred, non-legacy architectures. 
20 

21 It is thus advantageous to utilize embodiments of the present invention in 

22 situations where computer systems or networks including their management software 

23 designed in accordance with legacy architecture would otherwise be usefully employed in 
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communicating with other systems or networks including their other management 
software designed in accordance with other preferred, non-legacy architecture. 



l 
2 

3 

4 It is therefore a general object of the present invention to provide an improved 

5 computer program product to be operated on a computer system or within a computer 

6 network. 
7 

8 It is still yet another general object of the present invention to provide an interface 

9 between two architecturally-incompatible networks to automatically convert otherwise 

10 incompatible management software communication therebetween to compatible 

11 management software communication. 
12 

13 It is a further object of the present invention to provide a translator-compiler for 

14 converting legacy management software compatible with legacy or proprietary 

15 architecture to compatibility with preferred, standard, non-legacy architecture. 
16 

17 it is a still further object of the present invention to provide a translator-compiler 

18 to make storage, printer, server or other-component management software employed on, 

19 in or with computer systems, computer networks, computer methods, and computer 

20 program products written in a first computer language which is compatible with legacy 

21 architecture, to be automatically compatible with otherwise-incompatible new or different 

22 management software compatible with preferred, non-legacy architecture. 
23 
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1 Other objects and advantages will be understood after referring to the detailed 

2 description of the preferred embodiments and to the appended drawings wherein: 

3 
4 

5 BRIEF DESCRIPTION OF THE DRAWINGS 

6 Fig. 1 is a block diagram of a computer network, suggesting its basis on legacy 

7 architecture, and therefore a network of the type in which embodiments of the present 

8 invention can be utilized; 

9 Fig. 2A is a schematic representation of one legacy architecture; 

10 Fig. 2B is a schematic representation of an example of standard, non-legacy 

11 architecture; 

12 Fig. 3 is a schematic diagram reflecting usage of embodiments of the present 

13 invention with the legacy architecture; 

14 Fig. 4 is a flowchart depicting an algorithm performed by embodiments of the 

15 present invention; and, 

16 Fig. 5 is a flowchart depicting an algorithm performed by alternate embodiments 

17 of the present invention. 
18 

19 

20 DESCRIPTION OF THE PREFERRED EMBODIMENTS 

21 Figure 1 - Computer Network 

22 Referring to Fig. 1, there is presented a block diagram of a computer network, 

23 with an indication of its basis in or on legacy architecture, and is therefore a network of 
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1 the type in which embodiments of the present invention can be advantageously utilized. 

2 Computer network 105 is shown containing client or head-station computer system 101 . 

3 Computer system 10 1 is designed and built in accordance with legacy architecture 

4 (intended to be suggested in Fig. 1 by block 100 and shown schematically in Fig. 2A). 

5 Management user interface software 108 (such as proprietary N A VI SPHERE® software, 

6 a registered trademark of assignee) can run on top of such legacy architecture. Such 

7 architecture and proprietary management software is deployed throughout computer 

8 network 105 as suggested by blocks 100/108 appearing in server 103 and storage system 

9 or storage area network (SAN) 104. Server 103 is a dedicated computer operating 

J 10 between client computer system 101 and SAN 104 via bi-directional busses 106 and 107 

;J 
si 

t ll for purposes of serving its client relative to such SAN. Other network configurations 

I 12 may not need such a server where the connection between client computer system 101 

i 13 and SAN 1 04 would be direct; server 1 03 is shown in dashed line format to indicate its 

? 14 absence in those other configurations. Management software 108, distributed as shown 

i 15 throughout the network, manages at least storage system or SAN 104. I/O bus 102 is 

I 16 shown operatively coupled to server 103 and connects network 105 to other networks 

17 (not shown). I/O bus 102 could alternatively be operatively coupled directly to storage 

18 system or SAN 104 instead, or in absence, of server 103. In particular, I/O bus 102 can 

19 serve as a connection to other management software used in such other networks. As 

20 noted, it is with this kind of network configuration based on legacy architecture that 

21 embodiments of the present invention are particularly useful. 

22 
23 

15 
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1 Figure 3 - Schematic Diagram 

2 Referring next to Fig. 3, a schematic diagram reflecting usage of embodiments of 

3 the present invention with legacy architecture is presented. This particular example 

4 involves RAID++, which is derived from and related to C++ object-oriented language. It 

5 should be understood that the present invention is not limited to usage with RAID++, 

6 C++, or any other language. Legacy Architecture stack 100 is shown and built bottom-up 

7 as follows: TCP/IP, Sockets, Rogue Wave, C++, and RAID++. RATD++ is shown 

8 divided into its header and data files for convenience of explanation hereinbelow. 
9 

10 In an overview of operation of a particular embodiment of the present invention, 

11 these header files are input, in source code format, to translator 300 over bus 308 where 

12 they are manipulated to locate certain or all public functions and/or data attributes of the 

13 header files as detailed in discussion of Fig. 4 hereinbelow. Output of translator 300, 

14 (more detail provided about translator 300 in connection with discussion of algorithms 

15 depicted in flowcharts in succeeding figures), is emitted to, or poured-into, file(s) in 

16 block 301, shown as source code files for converting RAID++ to CIM/XML. Such 

17 translator output source code (a translated-form of RAID++ headers) is forwarded from 

18 block 30 1 to block 3 02 where it is compiled into machine language (binary 1 s and 0s) 

19 and linked with RATD++ machine language obtained over bidirectional bus 304. These 

20 two combined and linked machine languages form an executable program capable of 

21 converting RATD++ to CIM/XML. In this example, need for communication in 

22 XML/CIM, which is the same language as CIM/XML, is presented by way of an Internet 

23 requirement - HTTP web server 303 is accessed and needs to provide outputs in 

16 
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1 XML/CIM. An HTTP GET command, for example, may appear over bus 306, as when a 

2 user requests access to a particular Internet address. Such command is processed in 

3 server block 303 in XML/CM language, forwarded over bidirectional bus 305 to block 

4 302. The executable program in block 302 has the ability to accept requests in CEVI 

5 language, such as this request, then query RAID++ over bidirectional bus 304, then 

6 obtain a result in RAID++, then convert such result into CM/XML, and then return that 

7 result to block 303 . Block 303 transmits such result, with any needed buffering and 

8 processing done by web server 303, over output bus 307 to the destination from which, or 

9 related to that destination from which, the request arrived on input bus 306. Input and 
O 10 output busses 306 and 307 may thus be equivalent to I/O bus 102 in Fig. 1 . 

ii 

J 12 Figure 4 - Flowchart 

%j 13 Fig. 4 is a flowchart depicting an algorithm performed by translator 300 utilized 

□ U in certain embodiments of the present invention. The algorithm starts with step 40 1 

iijLi 

5f 15 opening a header file containing a declaration of an object. This header file contains 

y * 

P 16 information that needs to be converted into CIM/XML. In this step, the file is just being 

17 opened but not being parsed or looked at. 
18 

19 in the following specific illustrative example in Table I of an input to the 

20 translator, which is not to be considered as limiting the invention in any manner, such 

21 header file is equivalent to a RAID++ header file on bus 308 shown in Fig. 3. This 

22 particular input example is a header file that models a disk drive. The file is called 

23 "diskdevice.hxx", and the implementation is C++: 

17 
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1 

2 

3 TABLE I 

4 

5 RAID ++ HEADER INPUT TO TRANSLATOR 

6 . 

7 #include "device, hxx" 

8 

9 class DiskDevice : public Device 

10 { 

11 public: 

12 

13 

14 boolean IsFaulted() const; 

15 char *GetVendorName() const; 

16 unsigned int GetBlocksRead() const; 

17 unsigned int GetBlocksWritten() const; 
18 

19 

20 }; 

21 

22 

23 As noted, this is an example of an input to translator 300 on bus 308. This class models 

24 a disk, and contain attributes such as whether or not the disk is experiencing a fault 

25 condition, what the name of the vendor was that built the disk, and how many blocks 

26 have been read and written to disk. Although this input is a class written in C++, it could 

27 have easily been a 'C struct (in the "C" language which is not an object oriented 

28 language), a Pascal record, or a JAVA class. 
29 

30 Next, the algorithmic process moves to step 402 where the aforementioned header 

3 1 file input example is parsed until the declaration is found, i.e., until the name of "class" 

32 (or "struct" if it had been in "C") along with any "parent class" name, if there is 
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inheritance, is found. In other words, each line of the header file in the above sample 
input is read-in to translator 300 up to the point that the declaration for the C++ class is 
discovered. The name of the C++ class is remembered. If the declaration contains an 
inheritance construct (in this case, the DiskDevice class inherits from Device), then the 
name of the parent class is recorded as well. Thus, for this example: 

TABLE II 

DECLARATION CONTAINS INHERITANCE CONSTRUCT 

ClassName = "DiskDevice" 
ParentClass = "Device" 



Parsing means reading every line of code in the file and intelligently interpreting all 
syntax to get the accurate message out of each line of code. When the word "class" is 
found during such parsing, the next token or piece of information on that line is class 
name, and if a colon syntax is found that means "inheritance" where the next token after 
that is parent name. This methodology is understood by those skilled in C++ language. 

Next the algorithmic process moves to step 403 where an output file is opened or 
created which is initally empty, and then a header is emitted into it. The header 
information includes "include" files, a function header and a function preamble. A 
principal purpose of translator 300 is to output source code that can be "called" to 
generate CIM/XML data for legacy objects written in various languages (C++ in this 
example). Thus, step 403 creates a new file, initially empty, that will eventually contain 

19 
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l a 



2 



5 



7 



10 



subroutine or function (to be described) that will perform that generation of CIM/XML 



data. For illustrative purposes, consider that an output file is created with acronym 

3 "XML", which, in this example would be XMLdiskdevice.cxx. The translator will emit 

4 into this file an entire subroutine responsible for accepting a DiskDevice object and 
generating XML from it. In this example, if translator 300 receives the "diskdevice.hxx" 



6 input shown in Table I above the translator should generate an output in response to such 



particular input, which is block 301, and which can have the following detailed format in 

C++: 

TABLE m 

H TRANSLATOR SOURCE CODE OUTPUT BASED ON TABLE I INPUT 

12 

13 #include "diskdrive.hxx" // emit header file 
14 

15 // step B - emit parent class function footprint, if inheritance 

16 

17 extern void XMLGenerateDevice(Device &Device, 

18 LinkedList<String> &XMLOutput, 

19 LinkedList<String> &InheritTree, 

20 String RequestedClass, 

21 boolean Local Only, 

22 boolean IncludeClassOrigin, 

23 boolean Deeplnheritance, 

24 boolean IncludeQualifiers, 

25 LinkedList<String> &PropertyList); 

26 

27 // step C - emit function header for class 
28 

29 void 

30 XMLGenerateDiskDevice(DiskDevice &Disk, 

31 LinkedList<String> &XMLOutput, 

32 LinkedList<String> &InheritTree, 

33 String RequestedClass, 

34 boolean LocalOnly, 

35 boolean IncludeClassOrigin, 

36 boolean Deeplnheritance, 

37 boolean IncludeQualifiers, 
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LinkedList<String> &PropertyList) 



3 // step D - if inheritance, call the XML generate routine for the parent 

4 class 
5 

6 XMLGenerateDevice(Disk, XMLOutput, InheritTree, RequestedClass, 

7 LocalOnly, 

8 IncludeClassOrigin, Deeplnheritance, 

9 IncludeQualifiers, PropertyList); 
10 

1 1 H step E - add the name of this class to the list that keeps track of 

12 classes in the inheritance hierarchy 

13 

14 InheritTree.append("DiskDevice"); 

15 

1 6 // step F - add an "if clause to determine if any CM/XML statements 

17 should be output for this class 
18 

19 If ((RequestedClass.compareTo("DiskDevice") = TRUE) 1 1 

20 ((InheritTree. contains(RequestedClass) = TRUE) && 

21 (Deeplnheritance == 

22 TRUE)) || 

23 (LocalOnly == FALSE)) 

24 { . 

25 



26 

27 Translator 300 follows the following steps to generate the above output code, 

28 (where steps are labeled to match labels of output results in the above output example): 

29 STEP A : Translator 300 generates an include statement that includes the output header 

30 file. In this case, the translator has opened the file "diskdevice.hxx", so that is the output 

31 that is emitted. 

32 STEP B : If the translator detects inheritance it must generate an external function 

33 declaration that will be used inside the body of the subroutine. In this example, the 

34 translator knows that parent class is called "Device", and that the body of the subroutine 

35 will need to call XMLGenerateDevice. Thus, translator 300 declares the footprint of that 
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1 routine. (All arguments declared in this external function declaration will be described in 

2 detail hereinbelow.) 

3 STEP C: The actual subroutine for generating XML from the C++ DiskDevice class will 

4 now be emitted by translator 300. First the translator outputs a Void" statement, because 

5 the routine returns nothing. Next, what is output is the actual declaration of function: 

6 XMLGenerateDiskDevice, followed by arguments. A description of each argument and 

7 what it is needed for is as follows: 

8 • DiskDevice &Disk: This is the actual DiskDevice class that is going to be 

9 converted to CIM/XML 

10 • LinkedList<String> &XMLOutput This an empty list of strings that will be 

1 1 populated with the actual CIM/XML information result. 

12 • LinkedList<Strmg> &InheritTree: This is a list of strings that contains names 

13 of all classes that are parents of the current class. This list is initially empty 

14 but as each class gets called, name of class is filled in (see step E). 

15 • String RequestedClass: This string contains name of class that is being 

16 queried. It might be expected that in this example, it would always be 

17 "DiskDevice", but it is quite possible that DiskDevice is a parent of another 

18 class (say RamDiskDevice), and that the client wishes to query the 

19 "RamDiskDevice" subclass (which includes attributes from DiskDevice and 

20 Device). 

21 NOTE: the following parameters are part of the incorporated-by-reference document 

22 relating to the DMTFspecification for CIM Operations. 

23 • boolean LocalOnfy: This parameter indicates whether or not the client 

22 
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1 wishes to view attributes that are just local to the requested class (LocalOnly 

2 equals TRUE), or additionally for any parent classes (LocalOnly = FALSE) 

3 • boolean IncludeClassOrigin: This boolean indicates whether or not a 

4 "CLASSORIGIN" attribute tag should be appended to each attribute within 

5 the object 

6 • boolean Deeplnheritance: This boolean indicates whether or not the client 

7 also wishes to view the attributes that are contained in child classes 

8 • boolean IncludeQualifiers: This boolean indicates whether or not the client 

9 wishes to append qualifier tags to each attribute within the object 

5 10 • LinkedList<String> &PropertyList: If this list is non-empty, it means the 

2 ll client wishes to only see certain attributes within an object, and not all of 
= E 12 them. 

Si 13 STEP D: The code that the translator must next generate is a call to the parent class' 

3 14 GenerateXML routine (if there is a parent class). This insures that the parent class (and 
% 15 other classes above it in the inheritance hierarchy) get a chance to append its (and their) 
t? 16 attributes respectively to the XMLOutput list if this is desired. This also gives parent 

17 classes a chance to add their names to the InheritTree list (see the next step). 

18 STEP E: As noted, the Inherit tree contains names of all parent classes in the inheritance 

19 hierarchy. In this step, the DiskDevice class simply adds its name to the list. 

20 STEP F: This last step is a 3-part "if statement that must be output by the translator. All 

21 of the native to CEV1/XML conversion code exists within this "if statement. The 

22 purpose of the "if statement is to determine whether or not this CEVI "object" should be 

23 converted. The three clauses are determining: (1) If the client is specifically asking for 

23 
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1 this class (e.g. "DiskDevice"). If so, then the "if condition passes, or: (2) If the 

2 requested class is "above" the current class ("DiskDevice") in the inheritance hierarchy 

3 and Deeplnheritance is set to TRUE. The way to determine if the requested class is 

4 "above" is whether or not the name has been added to the inheritance list previously. This 

5 is essentially equivalent to the client requesting the "Device" class and also obtaining 

6 information about subclasses. (3) If the client is not specifically asking for this class, and 

7 not asking for a parent class, then it must be asking for a subclass (below the current 

8 class) and if LocalOnly is set to FALSE, that means it is acceptable to convert 

9 information about parent classes. This is equivalent to asking for "RamDiskDevice", 

10 which is a subclass of "DiskDevice". Thus, translator 300 emits these three clauses and 

1 1 its process moves on to the next step. 
12 

13 Next, the algorithmic process moves to step 404 where the input header file from 

14 step 402 is continued to be parsed to locate certain or all "public functions" and/or "data 

15 attributes". Although step 404 in Fig 4 is shown to locate all public functions and/or data 

16 attributes, under certain circumstances or in certain applications only a subset of all of 

17 them (certain selected ones of them) are desired. This step is where translator 300 

18 actually begins looking for data items to convert to CIM/XML format. This could be in 

19 the form of public member functions such as those which would be found in C++ or Java, 

20 and/or public data items or attributes as those which would be found in C structs or 

21 Pascal records. Translator 300 must skip any protected or private routines/data, as well as 

22 constructors, destructors, operators, etc. Typically the translator would skip any complex 

23 routines that accept arguments. Also, translator 300 may or may not skip complex return 
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1 types, such as other objects or structs. A method could be written however, to handle 

2 complex return types by converting the return value to CIM/XML. As the translator 

3 locates public functions and/or attributes, it stores two things: type and name. These 

4 elements are stored to be used as part of XML code generation. (As will be explained in 

5 connection with an alternative embodiment example illustrated in Fig. 5, such alternative 

6 embodiment does not store all information until it is finished locating certain or all public 

7 functions and/or attributes as does this embodiment illustrated in Fig. 4.) For the 

8 input/output example shown above in TABLE I and TABLE II, the translator would 

9 store the following 4 pairs: 

10 1 . Type = boolean, Name = IsFaulted 

11 2. Type = char *, Name = GetVendorName 

12 3. Type = unsigned int, Name = GetBlocksRead 

13 4. Type = unsigned int, Name = GetBlocksWritten 
14 

15 Next, the algorithmic process moves to step 405 which is an iteration step to 

16 allow identification and processing of all type/name pairs. At this point the translator has 

17 parsed the entire input header file, and is now ready to generate code that converts data to 

18 CIM/XML format. Block 405 is just an iterator that starts on the 1 st pair in the preceding 

19 paragraph, (in this case "boolean/IsFaulted") and proceeds to step 406, until end of the 

20 list is reached whereupon the translator's algorithm proceeds to step 408. 
21 

22 Next, the algorithmic process moves to step 406 which emits code that calls each 

23 public function and/or data attribute and converts each result to CIM/XML format. In 
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1 other words, the result of this translator 300 step emits source code into output file 301 

2 that has capability (after compiling and linking in block 302, to be described further) to 

3 convert RAID++ data values (obtained via bus 304) into CM/XML. A sample output 

4 based on the first pair in the description of step 405 hereinabove, namely the "IsFaulted" 

5 variable in the DiskDevice class is as follows: 
6 

7 TABLE IV 

8 SAMPLE OUTPUT OF SOURCE CODE EMITTED BY TRANSLATOR 300 

9 BASED ON IS FAULTED VARIABLE 

10 

1 1 II Step G - check the property list to see if this variable should be 

12 converted 
13 

14 if ((PropertyList. isEmpty() = TRUE) 1 1 

15 (PropertyList.contains("IsFaulted") = TRUE)) 

16 { 

17 // STEP H - make the call to get the data value 

18 boolean vIsFaulted = IsFaulted(); 

19 

20 // STEP I - begin PROPERTY tag 

21 String PropertyString = "<PROPERTY NAME=\"IsFaulted\" " ; 
22 

23 // STEP J - include CLASS origin if desired 

24 if (IncludeClassOrigin == EVTRUE) 

25 { 

26 PropertyString += " CLASSORIGIN=\"DiskDevice\" " ; 

27 } 
28 

29 // STEP K - end the property tag by including the type 

30 PropertyString += "TYPE=Y'boolean\" >" ; 
31 

32 // STEP L - emit the property tag 

33 XMLStrings.append(PropertyString); 

34 

35 // STEP M - create a string to store a string version of the boolean 

36 char BooleanValue[128]; 

37 S printf(BooleanValue,"%s",(vIsFaulted ? "TRUE" : "FALSE")); 
38 

39 // STEP N - begin VALUE tag 

26 



"in 'i Mmwpiinim " ' m 



Assignee docket No: EMC-00-135; Attorney docket No. JW-EMC-007 



PATENT 



String ValueString - "<VALUE> + BooleanValue; 



2 



4 



5 



// STEP 0 - end value tag and emit 
ValueString = ValueString + "</VALUE>"; 
XMLStrings.append(ValueString); 



6 
7 



// STEP P - emit PROPERTY end tag and closing brace 
XMLStrings.append("</PROPERTY>''); 



8 



9 



10 

1 1 Steps which the translator should use to generate the above output code is as follows 

12 (starting with letter "G" since the letter "F" was the last letter used to identify a prior step 

13 hereinabove): 

14 STEP G: Create an "if statement that tests whether or not the specific data value should 

15 be converted to CM/XML. In essence, if a client wants to view "all" variables, the 

16 PropertyList will be empty and the body of the "if statement is executed. Otherwise, the 



^ 17 client wishes to view only a subset of all variables. Thus, a test to determine if the name 

0 18 of this variable is in the list is needed. In our example, if "IsFaulted" is in the list, then 

£ 19 the body of the "if statement is executed. It should be understood that the translator can 

1 20 emit name "IsFaulted" because it parsed that name out in a previous step. 

21 STEP H: The next step is to actually get the data value that needs to be converted into 

22 CIM/XML. First, a variable needs to be declared to hold the result. Thus, the translator 

23 emits a variable declaration using the "type" it parsed out previously. It should be 

24 understood that the compiler may have to map the type from native language (whether it 

25 be int, boolean, char, etc.) into CUVI basic data types, which are defined by DMTF. In 

26 this case the data type is boolean, and the variable name is simply the name of the 



27 



M MIMHHIIHIII|II 



Assignee docket No: EMC-00-135; Attorney docket No. JW-EMC-007 PATENT 

1 subroutine prepended with a "v" for variable. Finally, the actual routine is called, which 

2 returns the value. 

3 STEP I: A CM/XML "PROPERTY" tag is generated. The PROPERTY tag is found in 

4 one of the incorporated by reference documents, the DMTF "Specification for CIM 

5 Operations over HTTP" . In addition to the tag itself, the NAME attribute is present and it 

6 is set equal to the value of the item being returned ("IsFaulted"). 

7 STEP J: Before adding the closing brace of the property tag, the translator must generate 

8 an "if statement which tests whether or not the client is asking for the 

9 "IncludeClassOrigin" attribute. If so, the body of the "if statement appends a 

? io "CLASSORIGIN=" attribute to the current property string, and then adds the name of the 

1 1 class which in this case is "DiskDevice" . Note that the translator can optionally generate 

2 12 a similar "if statement for the IncludeQualfiers boolean. In this example there are no 

ii 

^ 13 qualifiers (the incorporated by reference CIM specification offers more detail). 

3 14 STEP K: The last part of closing out the PROPERTY tag is to include an attribute which 
Jj 15 describes the type of the data value, using the "TYPE-' attribute statement. Once this is 
i 16 done (in this example it is a "boolean"), the final ">" can be added to close the opening 

17 PROPERTY tag statement. 

18 STEP L: Now that the property tag is complete, the translator emits a statement that 

19 appends the property tag to the list of strings containing the CIM/XML output. The 

20 translator could choose to emit it to a file, to a display, or in this case, a list of strings 

21 which will be processed later. 

22 STEP M: In this step, the translator must take the return value generated in step H and 

23 convert it to a string. In order for the translator to do this, it must know what "type" is 

28 
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being returned, and this type is part of the information parsed in accordance with step 

2 404. Based on type, a string is created and stored in a buffer. In this example, the 

3 boolean will result in CIM strings of "TRUE" or "FALSE" . If the CIM data type was a 

4 number such as uintl6 or uint32 it would be converted into a string and stored in the 

5 buffer. 

6 STEP N: The value created in Step M needs to be embedded within a CIM <VALUE> 

7 tag, which is defined in the incorporated by reference CEVI specification. 

8 STEP O: The end tag (</VALUE>) is appended onto the string created in STEP N, and 

9 finally the translator generates a statement appending the value tag in its entirety onto the 

10 string list, again choosing to emit to a list of strings. 

1 1 STEP P: Since the <VALUE> tag is embedded within a <PROPERTY> tag, the property 

12 tag needs to be closed with the </PROPERTY> keyword. The compiler emits this 

13 statement along with the closing brace that matches the "if statement for STEP G. 
14 

15 Steps G through P are executed for each type-value pair by iterating via 

16 connection 407 (in our example above only four type-value pairs were shown, but it is to 

17 be understood that there can be a vast number of such pairs), whereupon code shall have 

18 been emitted which, after additional steps of compiling such source code into machine 

19 language, and linking such machine language with other machine language obtained from 

20 RATD++, shall form an executable that is capable of translating every acceptable value 

21 from the RAID++ object obtained via bidirectional bus 304 into CEV1/XML. With 

22 respect to the specific example provided herein, what has thus been created is a server 

23 application that receives requests in the now-preferred and standard CEvI/XML language, 
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1 obtains objects in RAID++ (which is C++ object-oriented language, and this translator 

2 can operate with respect to any language, whether object-oriented or otherwise), and 

3 thereafter automatically provides appropriate responses to such requests in the preferred 

4 CIM/XML language! 

5 

6 Next, the algorithmic process moves to last step 408 wherein a closing statement 

7 is emitted. At this stage of the algorithmic process, translator 300 has generated source 

8 code for certain or all public functions and/or data attributes and it moves on to emit a 

9 closing brace matching the "if statement emitted in step 403, STEP F, followed by a 

10 closing brace for step 403, Step C. In the output example under step 403 hereinabove and 

11 shown in TABLE III, a routine was generated called "XMLGenerateDiskDevice". A 

12 software application or program can now "calf (the "caller") this routine and pass the 

13 "DiskDevice" C++ class into it (along with all other parameters). In other words, a 

14 request, such as HTTP GET or some other appropriate input as shown associated with 

15 input bus 306 can be received by HTTP web server 303, which may buffer and process 

16 such request and forward the buffered and processed result (which could be a simple 

17 function call) to executable code 302 over bidirectional bus 305. Such result may be the 

18 "calf noted above, where the executable code responds as described herein. And, upon 

19 completion of the routine, a CIM/XML code segment will be generated which, for an 

20 example, can take the following form: 
21 



22 



TABLE V 



23 
24 



CIM/XML CODE SEGMENT CORRESPONDING TO A PORTION OF 
COMPILED AND LINKED OUTPUT OF TABLE m SOURCE CODE 
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1 

2 <PROPERTY NAME= "IsFaulted" TYPE= "boolean "> 

3 <VALUE>FALSE</VALUE> 

4 </PROPERTY> 

5 <PROPERTY NAME= "GetVendorName " TYPE="string"> 

6 < VALUE>SEAGA TE</VALUE> 

7 </PROPERTY> 

8 <PROPERTYNAME= "GetBlocksRead " TYPE= "uint32 "> 

9 <VALUE>25639</VALUE> 

10 </PROPERTY> 

11 <PROPERTY NAME= "GetBlocksWritten " TYPE="uint32"> 

12 <VALUE>2349</VALUE> 

13 </PROPERTY> 

14 

15 
16 



f=i 17 This is not an example of an input to or an output from translator 300. This is not an 



|g 18 example of an input to or output from source code for converting RAID++ to CIM/XML 



H 19 block 301 . However, this is an example of a code segment written in XML/CIM 

W 20 language that ties-in with operation of compiled and linked executable 302 in connection 



:L 21 with the prior output example in TABLE III but is, by itself, not a valid XML document. 

j... 

I»r= 22 A valid XML document must have a root node and at least one child node. So the caller 



23 of the "XMLGenerateDiskDevice" routine must wrap this XML code with other 



24 statements, such as the following: 



25 



26 TABLE VI 

27 CIM/XML CODE SEGMENT OF TABLE V WRAPPED IN APPROPRIATE 

28 HEADER AND TRAILER 

29 

30 <?xml version=" 1 . 0" ?> 

31 <CIM CnvrVERSION="2.0" DTDVERSION="2.0" > 

32 <MESSAGE ID="877" PROTOCOLVERSION=" 1 .0" > 

33 <SIMPLERSP> 

34 <IMETHODRESPONSE NAME="EnumerateInstances" > 

35 <IRETURNVALUE> 
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1 <VALUE.NAMEDOBJECT> 

2 <INSTANCE CLASSNAME="NAV_DiskDevice" > 

3 <PROPERTY NAME= "IsFaulted" TYPE= "boolean "> 

4 <VALUE>FALSE</VALUE> 

5 </PROPERTY> 

6 <PROPERTY NAME="GetVendorName" TYPE="string"> 

7 <VALUE>SEAGATE</VALUE> 

8 <SPROPERTY> 

9 <PROPERTY NAME= "GetBlocksRead " TYPE="uint32"> 

10 <VALUE>25639<WALUE> 

11 </PROPERTY> 

12 <PROPERTY NAME= "GetBlocks Written " TYPE="uint32"> 

13 <VALUE>2349<VALUE> 

14 </PROPERTY> 

15 </INSTANCE> 

16 </V ALUE.NAMEDOB JECT> 

17 </IRETURNVALUE> 

18 </IMETHODRESPONSE > 

19 </SIMPLERSP> 

20 </MESSAGE> 

jl 21 </CIM> 

H 22 

T. 23 

W 24 

%l 25 Code appearing above the CIM/XML code segment (such segment shown in bold italics 

26 to clearly identify it) is called a header, and code appearing below the CIM/XML code 

m 27 segment is called a trailer. By wrapping the code segment within such header and trailer 

U 28 it then becomes usable by the caller. At this stage of operation of the present invention, 

29 the translator, the source code converter, and the executable code have cooperated with 

30 each other and any other hardware and software required to accomplish the principal task 

31 of automatically converting data values from a company's proprietary solution into an 

32 industry standard CIM/XML format. 

33 
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1 Figure 5 - Alternative Embodiment Flowchart 

2 Fig. 5 is a flowchart depicting an algorithm performed by alternative 

3 embodiments of the present invention. The algorithm is identical to that of Fig. 4 through 

4 step 403. In step 501, parsing of the RAID++ header file in the aforementioned example 

5 continues in order to locate certain selected ones of every or every public function and/or 

6 data attribute. As noted in connection with discussion of Fig. 4, although every public 

7 function and/or data attribute is shown in step 501 in Fig. 5, under certain circumstances, 

8 or in certain applications, only a subset or certain ones of the entire group of public 

9 functions and/or data attributes are desired and, therefore, located and utilized. A major 

10 difference between this step and step 404 is that this step does not store information 

11 representing each located public function and/or data attribute, as was done with step 

12 404. Accordingly, in step 502, upon locating a particular public function and/or data 

13 attribute, code is emitted that calls that particular public function and/or data attribute and 

14 converts the result to CIM/XML format. This is accomplished on a continuous and one- 

15 to-one basis in step 502, rather than, as performed in step 404, awaiting completion of 

16 locating certain or all public functions and/or data attributes each of which was stored 

17 until such completion, whereupon code was emitted in response to translating and 

18 otherwise processing all of them in seriatim but in a single conversion-to-CM/XML step. 

19 Then, in decision step 504, the query is made: are certain or all public functions and/or 

20 data attributes converted to CIM/XML format? If not, the process is repeated as shown 

21 by connection 503 back to the input of step 501. If yes, the process moves to step 505 

22 which emits a closing statement similar to that described above with Fig. 4, and the 

23 algorithm is done. 
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1 

2 Embodiments of the present invention are to be considered in all respects as 

3 illustrative and not restrictive, and can be constructed in object oriented language (such as 

4 C++, JAVA, etc.) and non-object oriented language (such as C, for example). In other 

5 words, communication, including management software communication, in a preferred 

6 language (object-oriented or otherwise) between any first computer system or network 

7 employing such preferred language on the one hand, and any second computer system or 

8 network internally using a different or less-preferred computer language on the other 

9 hand, can be achieved easily and automatically by usage of embodiments constructed in 
? !f 10 accordance with principles of the present invention. There could even be circumstances 
rf 1 1 under which both object-oriented and non-object-oriented languages used on separate 
z £ 12 systems operating at the same time are handled by embodiments utilizing principles of 
Hj 13 the present invention. Accordingly, the scope of the invention is indicated by the 

Q : 14 appended claims rather than by the foregoing description, and all changes which come 

; jf 15 within the meaning and range of equivalency of the claims are therefore intended to be 

:T" 16 embraced therein. 
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